home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1997 August / Walnut Creek CDROM.7z / VOL_400 / 436_01 / UPDATE.DOC < prev   
Encoding:
Text File  |  1994-10-06  |  11.7 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                               Update for INCON 3.1
  10.  
  11.  
  12.      The following are notable differences from previous versions:
  13.  
  14.           *    Input field handling has been moved into seperate modules
  15.                for alpha, integer, float, and template fields.  Each
  16.                handler routine does its own character matching.
  17.  
  18.           *    Floating-point fields are no longer treated as templates.
  19.  
  20.           *    The Page flags are gone.  One of the bits is used for the
  21.                Mixed template type; the other for the Debug flag.
  22.  
  23.           *    [Backspace] operation is fixed, so that it deletes the last
  24.                character in the field instead of just pulling it along with
  25.                the cursor.
  26.  
  27.           *    Template, float, and hidden fields no longer use a special
  28.                internal value to mark vacant field positions; they now use
  29.                the Fill value passed in the message block.  INCON.DOC
  30.                includes a full explanation of the implications of that.
  31.  
  32.           *    A "Stat Box" is available that shows all INCON parameters
  33.                and flags after modification, if any, by field
  34.                initialization.  INCON.DOC has full details.
  35.  
  36.           *    If the Debug flag is set, INCON automatically sets the
  37.                Message flag.  If the Message flag is not set, INCON does
  38.                not display run-time error messages and pause until you
  39.                press a key.  Instead, it returns immediately with the error
  40.                code.  That may have led to confusion in previous versions,
  41.                in which the demo program just bounced out of the test field
  42.                when there was a run-time error.  INDEMO.EXE, the
  43.                demonstration program, sets the Debug flag each time it
  44.                calls INCON with a new test field.  Once you exit the field,
  45.                Debug is cleared until you set up a new field.
  46.  
  47.           *    The INDEMO menu has a much cleaner look; each field is
  48.                accompanied by a line of explanatory text, displayed at the
  49.                bottom of the sreen.  INDEMO also has a pop-up help screen,
  50.                tied to the [F1] key, that lists INCON's reserved keys.  The
  51.                help screen is provided mainly to demonstrate how to use
  52.                INCON's extended-key trapping to provide special services to
  53.                users, and how to use AddAttr() to prepare text to be moved
  54.                into video memory.  See INCON.DOC for details.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      Update for INCON 3.1                                            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                               Using the Make Files
  74.  
  75.  
  76.           MAKE.BAT is supplied to run the make files; enter "make ?" or
  77.      just "make" to see a help message.  In addition to MAKE.BAT's named
  78.      parameters, you can supply additional compiler switches and defines on
  79.      the command line; MAKE.BAT concatenates them and stores them in an
  80.      environment variable.  The compiler command lines in the make files
  81.      are set up to use that variable if it exists.  Note, however, that you
  82.      can't use ';' to gang X parameters or use '=' to define strings, since
  83.      COMMAND.COM treats those characters as command-line delimiters.
  84.  
  85.           In the discussion of the make files below, an 'x' suffix appears
  86.      on some file names.  The suffix denotes the memory model, Small,
  87.      Compact, Medium, or Large, under which the file was compiled.
  88.  
  89.           MAKE.BAT assumes that MAKE.EXE is in C:\TC and that the make file
  90.      you want to process is in the current subdirectory.  It also limits
  91.      the choice of memory model you can compile under to the four listed
  92.      above.  If your home directory for MAKE.EXE is different, or if you
  93.      want to be able to compile under the Huge memory model, make the
  94.      required changes to MAKE.BAT.  Memory models are set in the
  95.      FOR...IN...DO statement.
  96.  
  97.  
  98.      INDEMLIB.MAK
  99.  
  100.           Operates entirely within the current subdirectory.  It creates
  101.      INCONx.LIB from the INCON source files, and INDEMO.EXE using the
  102.      library.  Use this make file if you will be testing changes to INCON,
  103.      and will be working mainly with one memory model.
  104.  
  105.           INDEMLIB.MAK creates object files with the same base name as the
  106.      source files from which they were derived, no matter what memory model
  107.      you compile under; be careful not to try to create a mixed-model
  108.      library.  You may create INCONx.LIB with or without debugging
  109.      information through a MAKE.BAT option.
  110.  
  111.  
  112.      INDEMO.MAK
  113.  
  114.           Creates INDEMOx.EXE in the current subdirectory from the INCON
  115.      object files; it does not create a library.  Object file names are the
  116.      base name of the source file, plus the memory model suffix.  You can
  117.      keep a set of object and executable files for each memory model in the
  118.      current subdirectory without conflict.
  119.  
  120.  
  121.      INLIB.MAK
  122.  
  123.           Does an unconditional build of a "production" library, with no
  124.      debugging information.  It stores object files in \TC\USR and creates
  125.      \TC\USR\INCONx.LIB from them.  It then erases all of the object files.
  126.      You can build INCONx libraries for small, compact, medium, and large
  127.  
  128.  
  129.  
  130.      Update for INCON 3.1                                            2
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      memory models by invoking MAKE.BAT over-and-over with the relevant M
  140.      parameter.
  141.  
  142.           If you don't have a \TC\USR subdirectory, or you want the
  143.      libraries to go somewhere else, change the definition of O_DIR.
  144.      INLIB.MAK adapts to changes in the output directory by creating a
  145.      response file to build INCONx.LIB at run-time.  It then moves the
  146.      INCON header files into the output directory and creates a header file
  147.      named INLIB.H.  When you link INCONx.LIB to your programs, you need
  148.      only
  149.  
  150.           #include "\outdir\inlib.h"
  151.      
  152.      to bring in the all of the required header files.  Since MAKE.EXE
  153.      doesn't allow redirection on the ECHO command, INLIB.MAK calls on
  154.      INLIB.BAT to create the response file and move the header files.
  155.  
  156.           Before creating the new library, INLIB.MAK erases an existing
  157.      library with the same name, but it still uses replace operations to
  158.      create the new library.  Therefore, you'll get "not found in library"
  159.      warnings as TLIB attempts to extract each module from a non-existent
  160.      library prior to adding it to the new library.  If that bothers you,
  161.      remove the "del" command that clobbers the old library, or change the
  162.      response file to use add operations.  The "del" command that purges
  163.      the old .BAK copy of the library is also extraneous, since a .BAK copy
  164.      is not created when the existing library is first deleted.  If you
  165.      prefer to keep the .BAK file around, or if you remove the line that
  166.      deletes the existing library, remove that command also.
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Update for INCON 3.1                                            3
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                     Files on the INCON 3.1 Distribution Disk
  206.  
  207.  
  208.           ADDATTR  ASM   Assembly language routine that prepares text to be
  209.                          moved directly into video memory.
  210.  
  211.           STRINGZ  ASM   Suite of assembly language string-handling
  212.                          routines.
  213.  
  214.           INDEMRSP BAT   Batch file called by both INDEMO.MAK and
  215.                          INDEMLIB.MAK to create the response files they
  216.                          need.  If this file is missing, it may be
  217.                          recreated from comments at the beginning of either
  218.                          of the .MAK files.
  219.  
  220.           INLIB    BAT   Batch file called by INLIB.MAK to create the
  221.                          response file it needs and to move the header
  222.                          files required by "production" versions of
  223.                          INCONx.LIB into the output directory.  If this
  224.                          file is missing, it may be recreated from comments
  225.                          at the beginning of the .MAK file.
  226.  
  227.           MAKE     BAT   Batch file for running the various .MAK files.
  228.                          Enter "make" or "make ?" on the command line to
  229.                          see a help message.
  230.  
  231.           INALPHA  C     Alpha field handler.
  232.  
  233.           INCON    C     Main loop, global initializations, run-time error
  234.                          handling, scrolling, and Stat Box.
  235.  
  236.           INDEMO   C     Demo source file.
  237.  
  238.           INFLOAT  C     Float field handler.
  239.  
  240.           INHELP   C     INDEMO help screen.
  241.  
  242.           ININTGR  C     Integer field handler.
  243.  
  244.           INTEMPL  C     Template field handler.
  245.  
  246.           INUTIL   C     Public utility routines.
  247.  
  248.           STRINGTS C     Source file for STRINGTS.EXE.
  249.  
  250.           INCON    DOC   INCON documentation.  If you want a hard copy of
  251.                          this file, it is formatted to print with standard
  252.                          settings (10 cpi, 66 lines/pg).
  253.  
  254.           INDEMO   DOC   INDEMO documentation.
  255.  
  256.           UPDATE   DOC   This file.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.      Update for INCON 3.1                                            4
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.           INDEMOS  EXE   Small-model version of the INCON demonstration
  272.                          program.
  273.  
  274.           STRINGTS EXE   Program for testing the routines in STRINGZ.ASM.
  275.  
  276.           ADDATTR  H     Header file for ADDATTR.ASM.
  277.  
  278.           INCON    H     Declarations for INCON.C.
  279.  
  280.           INDECL   H     Prototypes for public routines.
  281.  
  282.           INDEFS   H     Global definitions and declarations.
  283.  
  284.           INSTATS  H     Stat Box definitions and declarations.
  285.  
  286.           STRINGZ  H     Header file for STRINGZ.ASM.
  287.  
  288.           INDEMLIB MAK   Creates INCONx.LIB and INDEMO.EXE in the current
  289.                          subdirectory.
  290.  
  291.           INDEMO   MAK   Creates INDEMOx.EXE in the current subdirectory.
  292.  
  293.           INLIB    MAK   Creates "production" libraries in the output
  294.                          directory.
  295.  
  296.           ADDATTR  OBJ   Object file created from ADDATTR.ASM, for those
  297.                          who don't have TASM.  If that applies to you,
  298.                          don't destroy this or the next file, or you won't
  299.                          be able to rebuild them.
  300.  
  301.           STRINGZ  OBJ   Object file created from STRINGZ.ASM.
  302.  
  303.           INDEMO   PRJ   Project file for creating INDEMO.EXE from the
  304.                          Turbo C interactive environment.  See INDEMO.TC.
  305.  
  306.           STRINGTS PRJ   Project file for creating STRINGTS.EXE from the
  307.                          Turbo C interactive environment.
  308.  
  309.           INDEMO   TC    Turbo C configuration file for creating INDEMO.EXE
  310.                          from the Turbo C IDE.  Building from the IDE is
  311.                          similar to using INDEMO.MAK, except that you can't
  312.                          add a suffix to output file names.  When you do a
  313.                          Make, the new output files overwrite the old ones.
  314.                          If you plan to experiment with different memory
  315.                          models, its safest to do a Build All when you
  316.                          create INDEMO.EXE.
  317.                          
  318.                          If this file is missing or damaged, or you prefer
  319.                          to work with some other editor, set your tab size
  320.                          to 3 for all of the C source files.  Otherwise,
  321.                          they will look pretty weird.
  322.  
  323.           STRINGTS TC    Turbo C configuration file for creating
  324.                          STRINGTS.EXE from the Turbo C IDE.
  325.  
  326.  
  327.  
  328.      Update for INCON 3.1                                            5
  329.  
  330.  
  331.